Android 三种菜单（Menu）的实现

一、常用方法

• onCreateOptionsMenu(Menu menu)
  每次Activity一创建就会执行，一般只执行一次，创建并保留Menu的实例；

//获取MenuInflater
    MenuInflater inflater = getMenuInflater();
//加载Menu资源
    inflater.inflate(R.menu.option_menu_normal,menu);
    
//此方法必须返回true，否则不予显示
    return true；

• onPrepareOptionsMenu(Menu menu)
  每次menu被打开时，该方法就会执行一次，可用于对传入的旧Menu对象进行修改操作；

• onOptionsItemSelected(MenuItem item)
  每次menu菜单项被点击时，该方法就会执行一次；

@Override
public boolean onOptionsItemSelected(MenuItem item) {
    switch (item.getItemId()){
        case R.id.option_normal_1:
            return true; //返回true，将结束点击事件，不会进入下一级菜单
        case R.id.option_normal_2:
            return true;
        case R.id.option_normal_3:
            return true;
        case R.id.option_normal_4:
            return true;
        default:
            return super.onOptionsItemSelected(item); //不返回true，避免截断菜单项的点击事件
    }
}

• invalidateOptionsMenu()
  刷新menu里的选项里内容，它会调用onCreateOptionsMenu(Menu menu)方法

• onCreateContextMenu()
  创建控件绑定的上下文菜单menu，根据方法里的View参数识别是哪个控件绑定

• onContextItemSelected(MenuItem item)
  点击控件绑定的上下菜单menu的内容项

• invalidateOptionsMenu()
  通知系统刷新Menu，之后，onPrepareOptionsMenu会被调用

二、使用XML定义Menu

理论上而言，使用XML和Java代码都可以创建Menu。但是在实际开发中，往往通过XML文件定义Menu，这样做有以下几个好处：

• 使用XML可以获得更清晰的菜单结构
• 将菜单内容与应用的逻辑代码分离
• 可以使用应用资源框架，为不同的平台版本、屏幕尺寸创建最合适的菜单（如对drawable、string等系统资源的使用）

要定义Menu，我们首先需要在res文件夹下新建menu文件夹，它将用于存储与Menu相关的所有XML文件。

我们可以使用

、、三种XML元素定义Menu，下面简单介绍一下它们：

• 是菜单项的容器。
  • 元素必须是该文件的根节点，并且能够包含一个或多个和元素。
• 是菜单项
  • 用于定义MenuItem，可以嵌套 元素，以便创建子菜单。
• 是元素的不可见容器（可选）。
  • 可以使用它对菜单项进行分组，使一组菜单项共享可用性和可见性等属性。

其中，是我们主要需要关注的元素，它的常见属性如下：

• android:id：菜单项(MenuItem)的唯一标识
• android:icon：菜单项的图标（可选）
• android:title：菜单项的标题（必选）
• android:showAsAction：指定菜单项的显示方式。常用的有ifRoom、never、always、withText，多个属性值之间可以使用|隔开

名称	效果
always	菜单项永远不会被收纳到溢出菜单中，因此在菜单项过多的情况下可能超出菜单栏的显示范围。
ifRoom	在空间足够时，菜单项会显示在菜单栏中，否则收纳入溢出菜单中。
withText	无论菜单项是否定义了icon属性，都只会显示它的标题，而不会显示图标。使用这种方式的菜单项默认会被收纳入溢出菜单中。
never	菜单项永远只会出现在溢出菜单中。

• 在碎片中调用菜单时，要在Fragment的onCreate()方法中调用 setHasOptionsMenu(true) 方法使之显示出来。

三、三种菜单类型

1、选项菜单

• 选项菜单是一个应用的主菜单项，用于放置对应用产生全局影响的操作，如搜索/设置
• 包含多级子项的XML代码，通过onOptionsItemSelected(MenuItem item)返回值为true来截断

//包含多级子项的XML代码

<menu xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto">

    <item android:id="@+id/option_sub_file"
        android:title="文件"
        app:showAsAction="ifRoom">
        <menu>
            <item android:id="@+id/file_new"
                android:title="新建"/>
            <item android:id="@+id/file_save"
                android:title="保存"/>

            <item android:id="@+id/file_more"
                android:title="更多">
                <menu>
                    <item android:id="@+id/file_more_1"
                        android:title="更多1"/>
                    <item android:id="@+id/file_more_2"
                        android:title="更多2"/>

                    <item android:id="@+id/file_more_more"
                        android:title="更多更多">
                        <menu>
                            <item android:id="@+id/file_more_more_1"
                                android:title="更多更多1"/>
                            <item android:id="@+id/file_more_more_2"
                                android:title="更多更多2"/>
                        </menu>
                    </item>
                </menu>
            </item>
        </menu>
    </item>
</menu>

//Java代码

@Override
public boolean onCreateOptionsMenu(Menu menu) {
    MenuInflater inflater=getMenuInflater();
    inflater.inflate(R.menu.option_menu_normal,menu);
    return true;
}

@Override
public boolean onOptionsItemSelected(MenuItem item) {
    switch (item.getItemId()){
        case R.id.option_normal_1:
            return true;
        case R.id.option_normal_2:
            return true;
        case R.id.option_normal_3:
            return true;
        case R.id.option_normal_4:
            return true;
        default:
            return super.onOptionsItemSelected(item);
    }
}

2、上下文菜单

• 上下文菜单是用户长按某一元素时出现的浮动菜单。它提供的操作将影响所选内容，主要应用于列表中的每一项元素（如长按列表项弹出删除对话框）。上下文操作模式将在屏幕顶部栏（菜单栏）显示影响所选内容的操作选项，并允许用户选择多项，一般用于对列表类型的数据进行批量操作。

• 要提供浮动上下文菜单，可以参照以下步骤：

  • 在Activity或Fragment中调用 registerForContextMenu(View v) 方法，注册需要和上下文菜单关联的View。如果将ListView或GridView作为参数传入，那么每个列表项将会有相同的浮动上下文菜单。
  • 在Activity或Fragment中重写onCreateContextMenu方法，加载Menu资源。
  • 在Activity或Fragment中重写onContextItemSelected方法，实现菜单项的点击逻辑。

3、弹出菜单(不需要onCreateOptionsMenu方法)

• 弹出菜单以垂直列表形式显示一系列操作选项，一般由某一控件触发，弹出菜单将显示在对应控件的上方或下方。它适用于提供与特定内容相关的大量操作。

• 可以将弹出菜单的使用拆分为以下四个步骤：

  • 实例化PopupMenu，它的构造方法需要两个参数，分别为Context以及PopupMenu依赖的View对象。
  • 使用MenuInflater将Menu资源加载到PopupMenu.getMenu()返回的Menu对象中。
  • 调用setOnMenuItemClickListener方法为PopupMenu设置点击监听器。
  • 调用==PopupMenu.show()==将弹出菜单显示出来。

//XML文件代码

<menu xmlns:android="http://schemas.android.com/apk/res/android">
    <item android:id="@+id/popup_add"
        android:title="添加"/>
    <item android:id="@+id/popup_delete"
        android:title="删除"/>
    <item android:id="@+id/popup_more"
        android:title="更多"/>
</menu>

//Java文件代码

@Override
protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.activity_popup_menu);

    findViewById(R.id.popup_menu_view).setOnClickListener(new View.OnClickListener() {
        @Override
        public void onClick(View view) {
            PopupMenu popupMenu=new PopupMenu(PopupMenuActivity.this,view);//1.实例化PopupMenu
            getMenuInflater().inflate(R.menu.popup_menu,popupMenu.getMenu());//2.加载Menu资源

            //3.为弹出菜单设置点击监听
            popupMenu.setOnMenuItemClickListener(new PopupMenu.OnMenuItemClickListener() {
                @Override
                public boolean onMenuItemClick(MenuItem item) {
                    switch (item.getItemId()){
                        case R.id.popup_add:
                            Toast.makeText(PopupMenuActivity.this,"添加",Toast.LENGTH_SHORT).show();
                            return true;
                        case R.id.popup_delete:
                            Toast.makeText(PopupMenuActivity.this,"删除",Toast.LENGTH_SHORT).show();
                            return true;
                        case R.id.popup_more:
                            Toast.makeText(PopupMenuActivity.this,"更多",Toast.LENGTH_SHORT).show();
                            return true;
                        default:
                            return false;
                    }
                }
            });
            popupMenu.show();//4.显示弹出菜单
        }
    });
}